1 // Unobtrusive validation support library for jQuery and jQuery Validate
2 // Copyright (c) .NET Foundation. All rights reserved.
3 // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
4 // @version v3.2.11
5
6 /*jslint white: true, browser: true, onevar: true, undef: true, nomen: true, eqeqeq: true, plusplus: true, bitwise: true, regexp: true, newcap: true, immed: true, strict: false */
7 /*global document: false, jQuery: false */
8
9 (function (factory) {
10 if (typeof define === 'function' && define.amd) {
11 // AMD. Register as an anonymous module.
12 define("jquery.validate.unobtrusive", ['jquery-validation'], factory);
13 } else if (typeof module === 'object' && module.exports) {
14 // CommonJS-like environments that support module.exports
15 module.exports = factory(require('jquery-validation'));
16 } else {
17 // Browser global
18 jQuery.validator.unobtrusive = factory(jQuery);
19 }
20 }(function ($) {
21 var $jQval = $.validator,
22 adapters,
23 data_validation = "unobtrusiveValidation";
24
25 function setValidationValues(options, ruleName, value) {
26 options.rules[ruleName] = value;
27 if (options.message) {
28 options.messages[ruleName] = options.message;
29 }
30 }
31
32 function splitAndTrim(value) {
33 return value.replace(/^\s+|\s+$/g, "").split(/\s*,\s*/g);
34 }
35
36 function escapeAttributeValue(value) {
37 // As mentioned on http://api.jquery.com/category/selectors/
38 return value.replace(/([!"#$%&'()*+,./:;<=>?@\[\\\]^`{|}~])/g, "\\$1");
39 }
40
41 function getModelPrefix(fieldName) {
42 return fieldName.substr(0, fieldName.lastIndexOf(".") + 1);
43 }
44
45 function appendModelPrefix(value, prefix) {
46 if (value.indexOf("*.") === 0) {
47 value = value.replace("*.", prefix);
48 }
49 return value;
50 }
51
52 function onError(error, inputElement) { // 'this' is the form element
53 var container = $(this).find("[data-valmsg-for='" + escapeAttributeValue(inputElement[0].name) + "']"),
54 replaceAttrValue = container.attr("data-valmsg-replace"),
55 replace = replaceAttrValue ? $.parseJSON(replaceAttrValue) !== false : null;
56
57 container.removeClass("field-validation-valid").addClass("field-validation-error");
58 error.data("unobtrusiveContainer", container);
59
60 if (replace) {
61 container.empty();
62 error.removeClass("input-validation-error").appendTo(container);
63 }
64 else {
65 error.hide();
66 }
67 }
68
69 function onErrors(event, validator) { // 'this' is the form element
70 var container = $(this).find("[data-valmsg-summary=true]"),
71 list = container.find("ul");
72
73 if (list && list.length && validator.errorList.length) {
74 list.empty();
75 container.addClass("validation-summary-errors").removeClass("validation-summary-valid");
76
77 $.each(validator.errorList, function () {
78 $("<li />").html(this.message).appendTo(list);
79 });
80 }
81 }
82
83 function onSuccess(error) { // 'this' is the form element
84 var container = error.data("unobtrusiveContainer");
85
86 if (container) {
87 var replaceAttrValue = container.attr("data-valmsg-replace"),
88 replace = replaceAttrValue ? $.parseJSON(replaceAttrValue) : null;
89
90 container.addClass("field-validation-valid").removeClass("field-validation-error");
91 error.removeData("unobtrusiveContainer");
92
93 if (replace) {
94 container.empty();
95 }
96 }
97 }
98
99 function onReset(event) { // 'this' is the form element
100 var $form = $(this),
101 key = '__jquery_unobtrusive_validation_form_reset';
102 if ($form.data(key)) {
103 return;
104 }
105 // Set a flag that indicates we're currently resetting the form.
106 $form.data(key, true);
107 try {
108 $form.data("validator").resetForm();
109 } finally {
110 $form.removeData(key);
111 }
112
113 $form.find(".validation-summary-errors")
114 .addClass("validation-summary-valid")
115 .removeClass("validation-summary-errors");
116 $form.find(".field-validation-error")
117 .addClass("field-validation-valid")
118 .removeClass("field-validation-error")
119 .removeData("unobtrusiveContainer")
120 .find(">*") // If we were using valmsg-replace, get the underlying error
121 .removeData("unobtrusiveContainer");
122 }
123
124 function validationInfo(form) {
125 var $form = $(form),
126 result = $form.data(data_validation),
127 onResetProxy = $.proxy(onReset, form),
128 defaultOptions = $jQval.unobtrusive.options || {},
129 execInContext = function (name, args) {
130 var func = defaultOptions[name];
131 func && $.isFunction(func) && func.apply(form, args);
132 };
133
134 if (!result) {
135 result = {
136 options: { // options structure passed to jQuery Validate's validate() method
137 errorClass: defaultOptions.errorClass || "input-validation-error",
138 errorElement: defaultOptions.errorElement || "span",
139 errorPlacement: function () {
140 onError.apply(form, arguments);
141 execInContext("errorPlacement", arguments);
142 },
143 invalidHandler: function () {
144 onErrors.apply(form, arguments);
145 execInContext("invalidHandler", arguments);
146 },
147 messages: {},
148 rules: {},
149 success: function () {
150 onSuccess.apply(form, arguments);
151 execInContext("success", arguments);
152 }
153 },
154 attachValidation: function () {
155 $form
156 .off("reset." + data_validation, onResetProxy)
157 .on("reset." + data_validation, onResetProxy)
158 .validate(this.options);
159 },
160 validate: function () { // a validation function that is called by unobtrusive Ajax
161 $form.validate();
162 return $form.valid();
163 }
164 };
165 $form.data(data_validation, result);
166 }
167
168 return result;
169 }
170
171 $jQval.unobtrusive = {
172 adapters: [],
173
174 parseElement: function (element, skipAttach) {
175 /// <summary>
176 /// Parses a single HTML element for unobtrusive validation attributes.
177 /// </summary>
178 /// <param name="element" domElement="true">The HTML element to be parsed.</param>
179 /// <param name="skipAttach" type="Boolean">[Optional] true to skip attaching the
180 /// validation to the form. If parsing just this single element, you should specify true.
181 /// If parsing several elements, you should specify false, and manually attach the validation
182 /// to the form when you are finished. The default is false.</param>
183 var $element = $(element),
184 form = $element.parents("form")[0],
185 valInfo, rules, messages;
186
187 if (!form) { // Cannot do client-side validation without a form
188 return;
189 }
190
191 valInfo = validationInfo(form);
192 valInfo.options.rules[element.name] = rules = {};
193 valInfo.options.messages[element.name] = messages = {};
194
195 $.each(this.adapters, function () {
196 var prefix = "data-val-" + this.name,
197 message = $element.attr(prefix),
198 paramValues = {};
199
200 if (message !== undefined) { // Compare against undefined, because an empty message is legal (and falsy)
201 prefix += "-";
202
203 $.each(this.params, function () {
204 paramValues[this] = $element.attr(prefix + this);
205 });
206
207 this.adapt({
208 element: element,
209 form: form,
210 message: message,
211 params: paramValues,
212 rules: rules,
213 messages: messages
214 });
215 }
216 });
217
218 $.extend(rules, { "__dummy__": true });
219
220 if (!skipAttach) {
221 valInfo.attachValidation();
222 }
223 },
224
225 parse: function (selector) {
226 /// <summary>
227 /// Parses all the HTML elements in the specified selector. It looks for input elements decorated
228 /// with the [data-val=true] attribute value and enables validation according to the data-val-*
229 /// attribute values.
230 /// </summary>
231 /// <param name="selector" type="String">Any valid jQuery selector.</param>
232
233 // $forms includes all forms in selector's DOM hierarchy (parent, children and self) that have at least one
234 // element with data-val=true
235 var $selector = $(selector),
236 $forms = $selector.parents()
237 .addBack()
238 .filter("form")
239 .add($selector.find("form"))
240 .has("[data-val=true]");
241
242 $selector.find("[data-val=true]").each(function () {
243 $jQval.unobtrusive.parseElement(this, true);
244 });
245
246 $forms.each(function () {
247 var info = validationInfo(this);
248 if (info) {
249 info.attachValidation();
250 }
251 });
252 }
253 };
254
255 adapters = $jQval.unobtrusive.adapters;
256
257 adapters.add = function (adapterName, params, fn) {
258 /// <summary>Adds a new adapter to convert unobtrusive HTML into a jQuery Validate validation.</summary>
259 /// <param name="adapterName" type="String">The name of the adapter to be added. This matches the name used
260 /// in the data-val-nnnn HTML attribute (where nnnn is the adapter name).</param>
261 /// <param name="params" type="Array" optional="true">[Optional] An array of parameter names (strings) that will
262 /// be extracted from the data-val-nnnn-mmmm HTML attributes (where nnnn is the adapter name, and
263 /// mmmm is the parameter name).</param>
264 /// <param name="fn" type="Function">The function to call, which adapts the values from the HTML
265 /// attributes into jQuery Validate rules and/or messages.</param>
266 /// <returns type="jQuery.validator.unobtrusive.adapters" />
267 if (!fn) { // Called with no params, just a function
268 fn = params;
269 params = [];
270 }
271 this.push({ name: adapterName, params: params, adapt: fn });
272 return this;
273 };
274
275 adapters.addBool = function (adapterName, ruleName) {
276 /// <summary>Adds a new adapter to convert unobtrusive HTML into a jQuery Validate validation, where
277 /// the jQuery Validate validation rule has no parameter values.</summary>
278 /// <param name="adapterName" type="String">The name of the adapter to be added. This matches the name used
279 /// in the data-val-nnnn HTML attribute (where nnnn is the adapter name).</param>
280 /// <param name="ruleName" type="String" optional="true">[Optional] The name of the jQuery Validate rule. If not provided, the value
281 /// of adapterName will be used instead.</param>
282 /// <returns type="jQuery.validator.unobtrusive.adapters" />
283 return this.add(adapterName, function (options) {
284 setValidationValues(options, ruleName || adapterName, true);
285 });
286 };
287
288 adapters.addMinMax = function (adapterName, minRuleName, maxRuleName, minMaxRuleName, minAttribute, maxAttribute) {
289 /// <summary>Adds a new adapter to convert unobtrusive HTML into a jQuery Validate validation, where
290 /// the jQuery Validate validation has three potential rules (one for min-only, one for max-only, and
291 /// one for min-and-max). The HTML parameters are expected to be named -min and -max.</summary>
292 /// <param name="adapterName" type="String">The name of the adapter to be added. This matches the name used
293 /// in the data-val-nnnn HTML attribute (where nnnn is the adapter name).</param>
294 /// <param name="minRuleName" type="String">The name of the jQuery Validate rule to be used when you only
295 /// have a minimum value.</param>
296 /// <param name="maxRuleName" type="String">The name of the jQuery Validate rule to be used when you only
297 /// have a maximum value.</param>
298 /// <param name="minMaxRuleName" type="String">The name of the jQuery Validate rule to be used when you
299 /// have both a minimum and maximum value.</param>
300 /// <param name="minAttribute" type="String" optional="true">[Optional] The name of the HTML attribute that
301 /// contains the minimum value. The default is "min".</param>
302 /// <param name="maxAttribute" type="String" optional="true">[Optional] The name of the HTML attribute that
303 /// contains the maximum value. The default is "max".</param>
304 /// <returns type="jQuery.validator.unobtrusive.adapters" />
305 return this.add(adapterName, [minAttribute || "min", maxAttribute || "max"], function (options) {
306 var min = options.params.min,
307 max = options.params.max;
308
309 if (min && max) {
310 setValidationValues(options, minMaxRuleName, [min, max]);
311 }
312 else if (min) {
313 setValidationValues(options, minRuleName, min);
314 }
315 else if (max) {
316 setValidationValues(options, maxRuleName, max);
317 }
318 });
319 };
320
321 adapters.addSingleVal = function (adapterName, attribute, ruleName) {
322 /// <summary>Adds a new adapter to convert unobtrusive HTML into a jQuery Validate validation, where
323 /// the jQuery Validate validation rule has a single value.</summary>
324 /// <param name="adapterName" type="String">The name of the adapter to be added. This matches the name used
325 /// in the data-val-nnnn HTML attribute(where nnnn is the adapter name).</param>
326 /// <param name="attribute" type="String">[Optional] The name of the HTML attribute that contains the value.
327 /// The default is "val".</param>
328 /// <param name="ruleName" type="String" optional="true">[Optional] The name of the jQuery Validate rule. If not provided, the value
329 /// of adapterName will be used instead.</param>
330 /// <returns type="jQuery.validator.unobtrusive.adapters" />
331 return this.add(adapterName, [attribute || "val"], function (options) {
332 setValidationValues(options, ruleName || adapterName, options.params[attribute]);
333 });
334 };
335
336 $jQval.addMethod("__dummy__", function (value, element, params) {
337 return true;
338 });
339
340 $jQval.addMethod("regex", function (value, element, params) {
341 var match;
342 if (this.optional(element)) {
343 return true;
344 }
345
346 match = new RegExp(params).exec(value);
347 return (match && (match.index === 0) && (match[0].length === value.length));
348 });
349
350 $jQval.addMethod("nonalphamin", function (value, element, nonalphamin) {
351 var match;
352 if (nonalphamin) {
353 match = value.match(/\W/g);
354 match = match && match.length >= nonalphamin;
355 }
356 return match;
357 });
358
359 if ($jQval.methods.extension) {
360 adapters.addSingleVal("accept", "mimtype");
361 adapters.addSingleVal("extension", "extension");
362 } else {
363 // for backward compatibility, when the 'extension' validation method does not exist, such as with versions
364 // of JQuery Validation plugin prior to 1.10, we should use the 'accept' method for
365 // validating the extension, and ignore mime-type validations as they are not supported.
366 adapters.addSingleVal("extension", "extension", "accept");
367 }
368
369 adapters.addSingleVal("regex", "pattern");
370 adapters.addBool("creditcard").addBool("date").addBool("digits").addBool("email").addBool("number").addBool("url");
371 adapters.addMinMax("length", "minlength", "maxlength", "rangelength").addMinMax("range", "min", "max", "range");
372 adapters.addMinMax("minlength", "minlength").addMinMax("maxlength", "minlength", "maxlength");
373 adapters.add("equalto", ["other"], function (options) {
374 var prefix = getModelPrefix(options.element.name),
375 other = options.params.other,
376 fullOtherName = appendModelPrefix(other, prefix),
377 element = $(options.form).find(":input").filter("[name='" + escapeAttributeValue(fullOtherName) + "']")[0];
378
379 setValidationValues(options, "equalTo", element);
380 });
381 adapters.add("required", function (options) {
382 // jQuery Validate equates "required" with "mandatory" for checkbox elements
383 if (options.element.tagName.toUpperCase() !== "INPUT" || options.element.type.toUpperCase() !== "CHECKBOX") {
384 setValidationValues(options, "required", true);
385 }
386 });
387 adapters.add("remote", ["url", "type", "additionalfields"], function (options) {
388 var value = {
389 url: options.params.url,
390 type: options.params.type || "GET",
391 data: {}
392 },
393 prefix = getModelPrefix(options.element.name);
394
395 $.each(splitAndTrim(options.params.additionalfields || options.element.name), function (i, fieldName) {
396 var paramName = appendModelPrefix(fieldName, prefix);
397 value.data[paramName] = function () {
398 var field = $(options.form).find(":input").filter("[name='" + escapeAttributeValue(paramName) + "']");
399 // For checkboxes and radio buttons, only pick up values from checked fields.
400 if (field.is(":checkbox")) {
401 return field.filter(":checked").val() || field.filter(":hidden").val() || '';
402 }
403 else if (field.is(":radio")) {
404 return field.filter(":checked").val() || '';
405 }
406 return field.val();
407 };
408 });
409
410 setValidationValues(options, "remote", value);
411 });
412 adapters.add("password", ["min", "nonalphamin", "regex"], function (options) {
413 if (options.params.min) {
414 setValidationValues(options, "minlength", options.params.min);
415 }
416 if (options.params.nonalphamin) {
417 setValidationValues(options, "nonalphamin", options.params.nonalphamin);
418 }
419 if (options.params.regex) {
420 setValidationValues(options, "regex", options.params.regex);
421 }
422 });
423 adapters.add("fileextensions", ["extensions"], function (options) {
424 setValidationValues(options, "extension", options.params.extensions);
425 });
426
427 $(function () {
428 $jQval.unobtrusive.parse(document);
429 });
430
431 return $jQval.unobtrusive;
432 }));
2 // Copyright (c) .NET Foundation. All rights reserved.
3 // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
4 // @version v3.2.11
5
6 /*jslint white: true, browser: true, onevar: true, undef: true, nomen: true, eqeqeq: true, plusplus: true, bitwise: true, regexp: true, newcap: true, immed: true, strict: false */
7 /*global document: false, jQuery: false */
8
9 (function (factory) {
10 if (typeof define === 'function' && define.amd) {
11 // AMD. Register as an anonymous module.
12 define("jquery.validate.unobtrusive", ['jquery-validation'], factory);
13 } else if (typeof module === 'object' && module.exports) {
14 // CommonJS-like environments that support module.exports
15 module.exports = factory(require('jquery-validation'));
16 } else {
17 // Browser global
18 jQuery.validator.unobtrusive = factory(jQuery);
19 }
20 }(function ($) {
21 var $jQval = $.validator,
22 adapters,
23 data_validation = "unobtrusiveValidation";
24
25 function setValidationValues(options, ruleName, value) {
26 options.rules[ruleName] = value;
27 if (options.message) {
28 options.messages[ruleName] = options.message;
29 }
30 }
31
32 function splitAndTrim(value) {
33 return value.replace(/^\s+|\s+$/g, "").split(/\s*,\s*/g);
34 }
35
36 function escapeAttributeValue(value) {
37 // As mentioned on http://api.jquery.com/category/selectors/
38 return value.replace(/([!"#$%&'()*+,./:;<=>?@\[\\\]^`{|}~])/g, "\\$1");
39 }
40
41 function getModelPrefix(fieldName) {
42 return fieldName.substr(0, fieldName.lastIndexOf(".") + 1);
43 }
44
45 function appendModelPrefix(value, prefix) {
46 if (value.indexOf("*.") === 0) {
47 value = value.replace("*.", prefix);
48 }
49 return value;
50 }
51
52 function onError(error, inputElement) { // 'this' is the form element
53 var container = $(this).find("[data-valmsg-for='" + escapeAttributeValue(inputElement[0].name) + "']"),
54 replaceAttrValue = container.attr("data-valmsg-replace"),
55 replace = replaceAttrValue ? $.parseJSON(replaceAttrValue) !== false : null;
56
57 container.removeClass("field-validation-valid").addClass("field-validation-error");
58 error.data("unobtrusiveContainer", container);
59
60 if (replace) {
61 container.empty();
62 error.removeClass("input-validation-error").appendTo(container);
63 }
64 else {
65 error.hide();
66 }
67 }
68
69 function onErrors(event, validator) { // 'this' is the form element
70 var container = $(this).find("[data-valmsg-summary=true]"),
71 list = container.find("ul");
72
73 if (list && list.length && validator.errorList.length) {
74 list.empty();
75 container.addClass("validation-summary-errors").removeClass("validation-summary-valid");
76
77 $.each(validator.errorList, function () {
78 $("<li />").html(this.message).appendTo(list);
79 });
80 }
81 }
82
83 function onSuccess(error) { // 'this' is the form element
84 var container = error.data("unobtrusiveContainer");
85
86 if (container) {
87 var replaceAttrValue = container.attr("data-valmsg-replace"),
88 replace = replaceAttrValue ? $.parseJSON(replaceAttrValue) : null;
89
90 container.addClass("field-validation-valid").removeClass("field-validation-error");
91 error.removeData("unobtrusiveContainer");
92
93 if (replace) {
94 container.empty();
95 }
96 }
97 }
98
99 function onReset(event) { // 'this' is the form element
100 var $form = $(this),
101 key = '__jquery_unobtrusive_validation_form_reset';
102 if ($form.data(key)) {
103 return;
104 }
105 // Set a flag that indicates we're currently resetting the form.
106 $form.data(key, true);
107 try {
108 $form.data("validator").resetForm();
109 } finally {
110 $form.removeData(key);
111 }
112
113 $form.find(".validation-summary-errors")
114 .addClass("validation-summary-valid")
115 .removeClass("validation-summary-errors");
116 $form.find(".field-validation-error")
117 .addClass("field-validation-valid")
118 .removeClass("field-validation-error")
119 .removeData("unobtrusiveContainer")
120 .find(">*") // If we were using valmsg-replace, get the underlying error
121 .removeData("unobtrusiveContainer");
122 }
123
124 function validationInfo(form) {
125 var $form = $(form),
126 result = $form.data(data_validation),
127 onResetProxy = $.proxy(onReset, form),
128 defaultOptions = $jQval.unobtrusive.options || {},
129 execInContext = function (name, args) {
130 var func = defaultOptions[name];
131 func && $.isFunction(func) && func.apply(form, args);
132 };
133
134 if (!result) {
135 result = {
136 options: { // options structure passed to jQuery Validate's validate() method
137 errorClass: defaultOptions.errorClass || "input-validation-error",
138 errorElement: defaultOptions.errorElement || "span",
139 errorPlacement: function () {
140 onError.apply(form, arguments);
141 execInContext("errorPlacement", arguments);
142 },
143 invalidHandler: function () {
144 onErrors.apply(form, arguments);
145 execInContext("invalidHandler", arguments);
146 },
147 messages: {},
148 rules: {},
149 success: function () {
150 onSuccess.apply(form, arguments);
151 execInContext("success", arguments);
152 }
153 },
154 attachValidation: function () {
155 $form
156 .off("reset." + data_validation, onResetProxy)
157 .on("reset." + data_validation, onResetProxy)
158 .validate(this.options);
159 },
160 validate: function () { // a validation function that is called by unobtrusive Ajax
161 $form.validate();
162 return $form.valid();
163 }
164 };
165 $form.data(data_validation, result);
166 }
167
168 return result;
169 }
170
171 $jQval.unobtrusive = {
172 adapters: [],
173
174 parseElement: function (element, skipAttach) {
175 /// <summary>
176 /// Parses a single HTML element for unobtrusive validation attributes.
177 /// </summary>
178 /// <param name="element" domElement="true">The HTML element to be parsed.</param>
179 /// <param name="skipAttach" type="Boolean">[Optional] true to skip attaching the
180 /// validation to the form. If parsing just this single element, you should specify true.
181 /// If parsing several elements, you should specify false, and manually attach the validation
182 /// to the form when you are finished. The default is false.</param>
183 var $element = $(element),
184 form = $element.parents("form")[0],
185 valInfo, rules, messages;
186
187 if (!form) { // Cannot do client-side validation without a form
188 return;
189 }
190
191 valInfo = validationInfo(form);
192 valInfo.options.rules[element.name] = rules = {};
193 valInfo.options.messages[element.name] = messages = {};
194
195 $.each(this.adapters, function () {
196 var prefix = "data-val-" + this.name,
197 message = $element.attr(prefix),
198 paramValues = {};
199
200 if (message !== undefined) { // Compare against undefined, because an empty message is legal (and falsy)
201 prefix += "-";
202
203 $.each(this.params, function () {
204 paramValues[this] = $element.attr(prefix + this);
205 });
206
207 this.adapt({
208 element: element,
209 form: form,
210 message: message,
211 params: paramValues,
212 rules: rules,
213 messages: messages
214 });
215 }
216 });
217
218 $.extend(rules, { "__dummy__": true });
219
220 if (!skipAttach) {
221 valInfo.attachValidation();
222 }
223 },
224
225 parse: function (selector) {
226 /// <summary>
227 /// Parses all the HTML elements in the specified selector. It looks for input elements decorated
228 /// with the [data-val=true] attribute value and enables validation according to the data-val-*
229 /// attribute values.
230 /// </summary>
231 /// <param name="selector" type="String">Any valid jQuery selector.</param>
232
233 // $forms includes all forms in selector's DOM hierarchy (parent, children and self) that have at least one
234 // element with data-val=true
235 var $selector = $(selector),
236 $forms = $selector.parents()
237 .addBack()
238 .filter("form")
239 .add($selector.find("form"))
240 .has("[data-val=true]");
241
242 $selector.find("[data-val=true]").each(function () {
243 $jQval.unobtrusive.parseElement(this, true);
244 });
245
246 $forms.each(function () {
247 var info = validationInfo(this);
248 if (info) {
249 info.attachValidation();
250 }
251 });
252 }
253 };
254
255 adapters = $jQval.unobtrusive.adapters;
256
257 adapters.add = function (adapterName, params, fn) {
258 /// <summary>Adds a new adapter to convert unobtrusive HTML into a jQuery Validate validation.</summary>
259 /// <param name="adapterName" type="String">The name of the adapter to be added. This matches the name used
260 /// in the data-val-nnnn HTML attribute (where nnnn is the adapter name).</param>
261 /// <param name="params" type="Array" optional="true">[Optional] An array of parameter names (strings) that will
262 /// be extracted from the data-val-nnnn-mmmm HTML attributes (where nnnn is the adapter name, and
263 /// mmmm is the parameter name).</param>
264 /// <param name="fn" type="Function">The function to call, which adapts the values from the HTML
265 /// attributes into jQuery Validate rules and/or messages.</param>
266 /// <returns type="jQuery.validator.unobtrusive.adapters" />
267 if (!fn) { // Called with no params, just a function
268 fn = params;
269 params = [];
270 }
271 this.push({ name: adapterName, params: params, adapt: fn });
272 return this;
273 };
274
275 adapters.addBool = function (adapterName, ruleName) {
276 /// <summary>Adds a new adapter to convert unobtrusive HTML into a jQuery Validate validation, where
277 /// the jQuery Validate validation rule has no parameter values.</summary>
278 /// <param name="adapterName" type="String">The name of the adapter to be added. This matches the name used
279 /// in the data-val-nnnn HTML attribute (where nnnn is the adapter name).</param>
280 /// <param name="ruleName" type="String" optional="true">[Optional] The name of the jQuery Validate rule. If not provided, the value
281 /// of adapterName will be used instead.</param>
282 /// <returns type="jQuery.validator.unobtrusive.adapters" />
283 return this.add(adapterName, function (options) {
284 setValidationValues(options, ruleName || adapterName, true);
285 });
286 };
287
288 adapters.addMinMax = function (adapterName, minRuleName, maxRuleName, minMaxRuleName, minAttribute, maxAttribute) {
289 /// <summary>Adds a new adapter to convert unobtrusive HTML into a jQuery Validate validation, where
290 /// the jQuery Validate validation has three potential rules (one for min-only, one for max-only, and
291 /// one for min-and-max). The HTML parameters are expected to be named -min and -max.</summary>
292 /// <param name="adapterName" type="String">The name of the adapter to be added. This matches the name used
293 /// in the data-val-nnnn HTML attribute (where nnnn is the adapter name).</param>
294 /// <param name="minRuleName" type="String">The name of the jQuery Validate rule to be used when you only
295 /// have a minimum value.</param>
296 /// <param name="maxRuleName" type="String">The name of the jQuery Validate rule to be used when you only
297 /// have a maximum value.</param>
298 /// <param name="minMaxRuleName" type="String">The name of the jQuery Validate rule to be used when you
299 /// have both a minimum and maximum value.</param>
300 /// <param name="minAttribute" type="String" optional="true">[Optional] The name of the HTML attribute that
301 /// contains the minimum value. The default is "min".</param>
302 /// <param name="maxAttribute" type="String" optional="true">[Optional] The name of the HTML attribute that
303 /// contains the maximum value. The default is "max".</param>
304 /// <returns type="jQuery.validator.unobtrusive.adapters" />
305 return this.add(adapterName, [minAttribute || "min", maxAttribute || "max"], function (options) {
306 var min = options.params.min,
307 max = options.params.max;
308
309 if (min && max) {
310 setValidationValues(options, minMaxRuleName, [min, max]);
311 }
312 else if (min) {
313 setValidationValues(options, minRuleName, min);
314 }
315 else if (max) {
316 setValidationValues(options, maxRuleName, max);
317 }
318 });
319 };
320
321 adapters.addSingleVal = function (adapterName, attribute, ruleName) {
322 /// <summary>Adds a new adapter to convert unobtrusive HTML into a jQuery Validate validation, where
323 /// the jQuery Validate validation rule has a single value.</summary>
324 /// <param name="adapterName" type="String">The name of the adapter to be added. This matches the name used
325 /// in the data-val-nnnn HTML attribute(where nnnn is the adapter name).</param>
326 /// <param name="attribute" type="String">[Optional] The name of the HTML attribute that contains the value.
327 /// The default is "val".</param>
328 /// <param name="ruleName" type="String" optional="true">[Optional] The name of the jQuery Validate rule. If not provided, the value
329 /// of adapterName will be used instead.</param>
330 /// <returns type="jQuery.validator.unobtrusive.adapters" />
331 return this.add(adapterName, [attribute || "val"], function (options) {
332 setValidationValues(options, ruleName || adapterName, options.params[attribute]);
333 });
334 };
335
336 $jQval.addMethod("__dummy__", function (value, element, params) {
337 return true;
338 });
339
340 $jQval.addMethod("regex", function (value, element, params) {
341 var match;
342 if (this.optional(element)) {
343 return true;
344 }
345
346 match = new RegExp(params).exec(value);
347 return (match && (match.index === 0) && (match[0].length === value.length));
348 });
349
350 $jQval.addMethod("nonalphamin", function (value, element, nonalphamin) {
351 var match;
352 if (nonalphamin) {
353 match = value.match(/\W/g);
354 match = match && match.length >= nonalphamin;
355 }
356 return match;
357 });
358
359 if ($jQval.methods.extension) {
360 adapters.addSingleVal("accept", "mimtype");
361 adapters.addSingleVal("extension", "extension");
362 } else {
363 // for backward compatibility, when the 'extension' validation method does not exist, such as with versions
364 // of JQuery Validation plugin prior to 1.10, we should use the 'accept' method for
365 // validating the extension, and ignore mime-type validations as they are not supported.
366 adapters.addSingleVal("extension", "extension", "accept");
367 }
368
369 adapters.addSingleVal("regex", "pattern");
370 adapters.addBool("creditcard").addBool("date").addBool("digits").addBool("email").addBool("number").addBool("url");
371 adapters.addMinMax("length", "minlength", "maxlength", "rangelength").addMinMax("range", "min", "max", "range");
372 adapters.addMinMax("minlength", "minlength").addMinMax("maxlength", "minlength", "maxlength");
373 adapters.add("equalto", ["other"], function (options) {
374 var prefix = getModelPrefix(options.element.name),
375 other = options.params.other,
376 fullOtherName = appendModelPrefix(other, prefix),
377 element = $(options.form).find(":input").filter("[name='" + escapeAttributeValue(fullOtherName) + "']")[0];
378
379 setValidationValues(options, "equalTo", element);
380 });
381 adapters.add("required", function (options) {
382 // jQuery Validate equates "required" with "mandatory" for checkbox elements
383 if (options.element.tagName.toUpperCase() !== "INPUT" || options.element.type.toUpperCase() !== "CHECKBOX") {
384 setValidationValues(options, "required", true);
385 }
386 });
387 adapters.add("remote", ["url", "type", "additionalfields"], function (options) {
388 var value = {
389 url: options.params.url,
390 type: options.params.type || "GET",
391 data: {}
392 },
393 prefix = getModelPrefix(options.element.name);
394
395 $.each(splitAndTrim(options.params.additionalfields || options.element.name), function (i, fieldName) {
396 var paramName = appendModelPrefix(fieldName, prefix);
397 value.data[paramName] = function () {
398 var field = $(options.form).find(":input").filter("[name='" + escapeAttributeValue(paramName) + "']");
399 // For checkboxes and radio buttons, only pick up values from checked fields.
400 if (field.is(":checkbox")) {
401 return field.filter(":checked").val() || field.filter(":hidden").val() || '';
402 }
403 else if (field.is(":radio")) {
404 return field.filter(":checked").val() || '';
405 }
406 return field.val();
407 };
408 });
409
410 setValidationValues(options, "remote", value);
411 });
412 adapters.add("password", ["min", "nonalphamin", "regex"], function (options) {
413 if (options.params.min) {
414 setValidationValues(options, "minlength", options.params.min);
415 }
416 if (options.params.nonalphamin) {
417 setValidationValues(options, "nonalphamin", options.params.nonalphamin);
418 }
419 if (options.params.regex) {
420 setValidationValues(options, "regex", options.params.regex);
421 }
422 });
423 adapters.add("fileextensions", ["extensions"], function (options) {
424 setValidationValues(options, "extension", options.params.extensions);
425 });
426
427 $(function () {
428 $jQval.unobtrusive.parse(document);
429 });
430
431 return $jQval.unobtrusive;
432 }));